ListParts

Description

ListParts interface can list all uploaded parts to which the specified Upload ID belongs.

Request Method

POST

Request Path

/apsara/route/OneRouter/ListParts

Request Parameters Common Parameters

Name	Location	Type	Required	Sample value	Description
encoding-type	BODY	string	No	url	specifies to encode the returned content and specify the type of encoding. Key uses UTF-8 characters, but the XML 1.0 standard does not support parsing some control characters, such as characters with ASCII values ranging from 0 to 10. If the Key contains control characters that are not supported by the XML 1.0 standard, you can encode the returned Key by specifying the encoding-type.
uploadId	BODY	string	No	0004B999EF5A239BB9138C6227D69F95	Multipart the ID of the Upload event. Default value: None
max-parts	BODY	integer	No	1000	specifies the maximum number of parts in OSS responses. type: integer default value: 1000
regionId	BODY	string	Yes	No sample value for this parameter.	region id
part-number-marker	BODY	integer	No	5	specifies the starting position of List, only Part whose number is greater than this parameter will be listed. type: integer default value: none
version	BODY	string	No	2016-01-01	version of api

Return data

Name	Type	Sample value	Description
NextPartNumberMarker	integer	5	if all results are not returned this time, the response request will contain NextPartNumberMarker elements to indicate the PartNumberMarker value of the next request.
PartNumber	integer	1	Number indicating Part.
Size	integer	6291456	Part size uploaded.
EncodingType	string	url	indicates the type used to encode the returned result. If encoding-type is specified in the request parameter, the key in the returned result is encoded.
IsTruncated	enumeration string	false	indicates whether the List Part result list returned this time is truncated. true indicates that all results have not been returned this time. false indicates that all results have been returned this time. valid values: true, false
MaxParts	integer	1000	returns the maximum number of parts in the request.
UploadId	string	0004B999EF5A239BB9138C6227D69F95	Upload event ID.
LastModified	date	2012-02-23T07:01:34.000Z	Part upload time.
PartNumberMarker	integer	5	Part Number starting position of this List result.
Bucket	string	multipart_upload	Bucket name.
ETag	string	3349DC700140D7F86A0784842780****	ETag of uploaded part content. type: parent node: ListPartsResult.Part
Part	container	not involved	container for holding part information.
ListPartsResult	container	not involved	container that holds ListParts request results.
Key	string	multipart.data	Object name.

Example

Successful Response example

{
 "NextPartNumberMarker":"5",
 "PartNumber":"1",
 "Size":"6291456",
 "EncodingType":"url",
 "IsTruncated":"false",
 "MaxParts":"1000",
 "UploadId":"0004B999EF5A239BB9138C6227D69F95",
 "LastModified":"2012-02-23T07:01:34.000Z",
 "PartNumberMarker":"5",
 "Bucket":"multipart_upload",
 "ETag":"3349DC700140D7F86A0784842780****",
 "Part":"not involved",
 "ListPartsResult":"not involved",
 "Key":"multipart.data"
}

Failed Response example

{
 "errorSample":
 {
  "resultCode":-1,
  "resultMsg":"system error",
  "result":null
 }

}